home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / GRAPHICS / POV_3 / ATARI.DOC next >
Encoding:
Text File  |  2005-08-13  |  13.5 KB  |  314 lines
  1.  
  2. /--------------------------------------------------------------------\
  3. ] Unofficial POVRay v3.00 for Atari M680x0 platform (x-port v1.01)   [
  4. \--------------------------------------------------------------------/
  5.  
  6. This is the final version of my PovRay v3.00 MS-DOS port to the Atari
  7. platform. Previous versions lacked PNG support due to unported ZLIB
  8. and PNG libraries, but this situation has now been rectified.
  9.  
  10. A brief word of warning:
  11.  
  12. Although POVRay v3.00 is based heavily on the algorithms from Dieter
  13. Bayer's FTPOV v2.2 and is therefore much quicker than the official
  14. POVRay v2.2, it does contain a lot of new features which are every bit
  15. as intensive as they are impressive. It is quite easy to produce a
  16. scene that will take forever to render even on the fastest of fast
  17. platforms. This means a number of the example images will render
  18. relatively slowly, and so give the false impression POV3 is actually
  19. slower than some of it's predecessors. For this reason, it may be
  20. worth experimenting with a few of the older scenes & capabilities
  21. before diving into things like atmospheric effects, focal blur,
  22. attenuated glass, halos and some of the other new processor-killing 
  23. functions which are now available.
  24.  
  25. It is STRONGLY ADVISED you equip yourself with AT LEAST a 68030
  26. processor and probably a 68881 or 68882 floating-point coprocessor
  27. as well. There is support for vanilla 68000 and 68030, but be prepared
  28. for IMMENSELY long render times if you do have to take this route. If
  29. you are lucky enough to own a 68040 processor with integral FPU, then
  30. you are not going to have too much of a problem at all. If you are
  31. absolutely DROWNING in luck and happen to have a 68060-based 'Hades060'
  32. or something like that, then you have far too much disposable income,
  33. and considering the nature of POV, probably far too much free time as
  34. well. :)
  35.  
  36. ]--------------------------------------------------------------------[
  37.  
  38. Operation:
  39.  
  40. The easiest way to launch POV is to add any special options to the
  41. POVRAY.INI file (or some other secondary INI file) and use:
  42.  
  43.  pov3.ttp -isource.pov [file.ini]
  44.  
  45. You don't actually need to specify for the default POVRAY.INI file
  46. because POV will find it automatically so long as it's in the same
  47. directory as the program. You can also use the 'POVINI' environment
  48. variable to point POV towards a specific default INI file, but you
  49. will still need a minimal standard POVRAY.INI beside the executable.
  50.  
  51. ~
  52.  
  53. Alernatively, you can specify the in/out filenames in the INI file
  54. itself and just use:
  55.  
  56.  pov3.ttp [file.ini]
  57.  
  58. You WILL need to specify POVRAY.INI here if you don't specify
  59. anything else or you will be presented with the help screen.
  60. Starting POV3 without a command line will ALWAYS bring up this
  61. help screen.
  62.  
  63. ~
  64.  
  65. Or if you are not keen on the INI file system (and why not???) you
  66. can always revert to the POV2 method:
  67.  
  68.  pov3.ttp -isource.pov -odest.tga -q9 +ft +dl +x +p +b30 povray.ini
  69.  
  70. ...etc...etc...
  71.  
  72. ~
  73.  
  74. Launching animations is more complicated, and depends on how the
  75. animation is set up. See POVRAY.DOC for details.
  76.  
  77. If you are using the 'internal animation loop' feature of POV3, then
  78. it is sufficient to set up the appropriate options in the main INI
  79. file in order to render an animation. If you are depending on the
  80. external animation loop, or shelling out to the CLI, then you will
  81. need to read the documentation because it can get very complicated.
  82.  
  83. ]--------------------------------------------------------------------[
  84.  
  85. Additions:
  86.  
  87. Preview display feature
  88. -----------------------
  89.  
  90. The most significant addition is 16-bit truecolour preview support
  91. (Falcon only) which can be invoked via the INI file or CLI. You can
  92. actually choose which 16-bit mode you want to use - low, medium or
  93. high (high is RGB only) and if you use Videlity, BlowUP, VI or
  94. FalconScreen, any custom TC modes you have set up will be available
  95. as required. Even if the mode is a non-standard aspect ratio (VGA
  96. medium = 320x480 or perhaps 416x624) then the program will adjust the
  97. preview render so it still looks 'square'.
  98.  
  99. [BlowUP users: Because BlowUP can't differentiate between desktop
  100. resolutions when changing video mode, all modes (low, medium & high) will
  101. result in exactly the same screen display. If you have not enabled a
  102. BlowUP TC mode then the normal desktop modes will be available instead.]
  103.  
  104. [ScreenBlaster users: Screenblaster has no VSetMode function, and so
  105. is completely incapable of supporting resolution changes other than
  106. via the Desktop. It can't be used with the preview modes for this very
  107. reason. Use another screen expander if you want preview support.]
  108.  
  109. The video mode INI file options are as follows:
  110.  
  111. Display = on/off    - enable/disable truecolour display
  112.  
  113. Video_Mode = l         - low res: 320x200/320x240/custom low
  114. Video_Mode = m         - med res: 320x400/320x480/custom med
  115. Video_Mode = h         - high res: 640x400/640x480/custom high
  116.  
  117. Alternatively, if you prefer to use the command line instead of the
  118. INI file, you can use:
  119.  
  120. -d            - disable display
  121.  
  122. +dl            - enable display (low res)
  123. +dm            - enable display (med res)
  124. +dh            - enable display (high res)
  125.  
  126. The display mode supports the following capabilities:
  127.  
  128. 1) Flexible truecolour display supporting both standard & custom modes.
  129. 2) Vista-buffer preview support.
  130. 3) Mosaic-preview support with automatic size correction.
  131. 4) Automatic display ratio correction - for 'brickbat' video modes.
  132. 5) Automatic size correction for images larger than display.
  133.  
  134. Future expansion will allow overscan modes to be used on RGB monitors.
  135.  
  136. Screenblanker
  137. -------------
  138.  
  139. The second important addition is the built-in Falcon screenblanker.
  140. When both 'verbose' and 'display' are disabled, in the 68030+ versions,
  141. a built-in screenblanker will kick in immediately after parsing has
  142. finished. This screenblanker will only turn off when the scene is
  143. interrupted by a keypress or when the scene has completed. Moving the
  144. mouse will not have any effect. The screen blanker speeds up rendering
  145. by a few % and stops your monitor burning out in the process.
  146.  
  147. Notes:
  148.  
  149. * Because the preview modes are Falcon-specific, you should not
  150.   attempt to use them on non-Falcon machines. The 68000 versions
  151.   do support the display and screenblanker features, but that is
  152.   only because they are based on the same sources. These features
  153.   will only work on the Falcon. If you are using a non-Falcon
  154.   machine, you should turn 'display' off and 'verbose' on.
  155.  
  156. ]--------------------------------------------------------------------[
  157.  
  158. Changes:
  159.  
  160. There are some small extras implemented in the Atari version for
  161. various reasons. They are listed here:
  162.  
  163. * When 'verbose' is disabled and 'display' is enabled, the credits
  164.   will not be shown. This speeds up execution and prevents loads of
  165.   text scrolling up the screen before anything happens. This is very
  166.   annoying when you are not using a very large screen mode, and you
  167.   have to wait for the scrolling to stop. Options are still shown for
  168.   practical reasons. If you want to read the credits (if that is
  169.   actually possible without redirecting the text into a file), then
  170.   you can turn the verbose switch back on to return things to normal.
  171.  
  172. * Because POV is such an excellent benchmarking program, it is
  173.   useful to be provided with accurate timing information for each
  174.   scene. Unfortunately, the original version used the system clock
  175.   and so was only accurate to the nearest 2 seconds. This special
  176.   version is internally accurate to 1/200th of a second, and the
  177.   final figures are accurate to 2 decimal places.
  178.   
  179. ]--------------------------------------------------------------------[
  180.  
  181. Omissions:
  182.  
  183. There are a number of things still missing from this Atari version and
  184. they are listed here for reference:
  185.  
  186. * ASCII console interface. This is MSDOS specific, isn't actually
  187.   needed for anything, and is quite annoying into the bargain. You
  188.   are basically not missing very much!
  189.  
  190. There may be other differences from the MSDOS version, but these are
  191. the ones I am currently aware of. There may also be some bugs which
  192. have not yet been discovered. Some bugs present in the MSDOS version
  193. have actually been fixed.
  194.  
  195. ]--------------------------------------------------------------------[
  196.  
  197. Bugs and other problems:
  198.  
  199. There are a few minor bugs and inconsistencies specific to this port
  200. which are described here:
  201.  
  202. * Multitasking support while using the display modes is unlikely to
  203.   work at the moment. This will be corrected in future versions. It
  204.   will however still work under Magic in single-tasking mode so it's
  205.   not a particularly serious problem. It just means everything else
  206.   has to stop while rendering takes place. The program will however
  207.   multitask quite happily if you don't enable the display option.
  208.  
  209. * The 68000/68881 version of the executable (POV3_SFP.TTP) has never
  210.   actually been tested. In fact, the floating point libraries used
  211.   in the program haven't even been tested since they were compiled
  212.   specifically for the creation of this program. If it doesn't work
  213.   then I'm afraid you'll just have to put up with the 68000 version.
  214.  
  215. ]--------------------------------------------------------------------[
  216.  
  217. Executables supplied:
  218.  
  219. * POV3_68K.TTP    - Atari/TOS compatible + 68000.
  220.  
  221.   This version should run on any Atari compatible machine, but it
  222.   will run very slowly. It contains no instructions which are not
  223.   supported on the 68000 processor. This means is the only binary
  224.   capable of running on a standard ST or STE.
  225.  
  226. * POV3_SFP.TTP    - Atari/TOS compatible + 68000 + I/O mapped 68881/2.
  227.  
  228.   This version will _only_ run on a 68000 based Atari compatible
  229.   with an I/O mapped 68881/2 coprocessor. This should include the
  230.   Mega/MSTE with 68881 FPU, although it has never actually been
  231.   tested...
  232.  
  233. * POV3_030.TTP    - Atari/TOS compatible + 68020/30/LC040.
  234.  
  235.   This version will run on any 68020, 68030, 68040/LC040 or even
  236.   68060 based Atari compatible, but it does not rely on a coprocessor
  237.   and will therefore run relatively slowly. It is ideal for use with
  238.   Falcon030, TT or PAK machines without an FPU. This is normally the
  239.   version you have to put up with while you are waiting for your
  240.   68882 to arrive! :)
  241.  
  242. * POV3_FPU.TTP    - Atari/TOS compatible + 68020/30 + 68881/2.
  243.  
  244.   This version will only run on 68020 or 68030 based Atari compatibles
  245.   with a 68881/2 coprocessor, or a 68040 or 68060 based machine with
  246.   the appropriate FPSP (Floating Point Software Package) installed.
  247.   This version is the best option for most Atari POV3 users, since
  248.   Falcon and TT machines are easily equipped with an FPU if they do
  249.   not contain one already. It is the second fastest of all these
  250.   executables.
  251.  
  252. * POV3_040.TTP    - Atari/TOS compatible + 68040/60 + 68040/60 FPSP.
  253.  
  254.   This special version is compiled _specifically_ for 68040 or 68060
  255.   based Atari compatibles with the appropriate FPSP (Floating Point
  256.   Software Package) installed. It will not run on any other type
  257.   of platform, due to it's extensive use of integral 68040 instuctions.
  258.   This version of POV3 is the fastest version of all. If you have a
  259.   68040 or 68060, then you really should use this version!
  260.  
  261. Notes:
  262.  
  263. * Machines equipped with a 68LC040 will be forced to use the POV3_030
  264.   binary because the LC chips have no integral FPU hardware.
  265.  
  266. * For practical reasons, it is suggested that users attempt to obtain
  267.   a hardware FPU if they do not have one already. POV3 is not the
  268.   kind of program that will run quickly without an FPU, if indeed
  269.   it can be called 'quick' under any circumstances - but lack of an
  270.   FPU will significantly increase rendering times and may even be
  271.   impractical for most purposes. The practical minimum specification
  272.   required to run POV3 is usually a 68030+68882 running at 16MHz or
  273.   more, but it depends a great deal on your level of patience. :)
  274.  
  275. * All versions supplied with this package are GCC++ v2.7.2 generated.
  276.  
  277. * I spent a long time experimenting with the GCC++ v2.7.2 compiler
  278.   optimisation switches to get these programs running as fast as
  279.   possible, so I know they are as close to 'fast' as they are going
  280.   to get with that compiler. Versions generated with other compilers
  281.   such as Lattice and Pure-C always result in slower code, except
  282.   in the case of vanilla 68000, where Lattice appears to have a
  283.   slight edge due to slightly better 68k software float libraries.
  284.  
  285. * Anyone using the 68040 version should be made aware that installing
  286.   a copy of the 'MC68040 ToolKit' driver software in the auto folder
  287.   will GREATLY accelerate rendering to something like 250% normal
  288.   expected performance. You can achieve even more speed by using the
  289.   supplied ECBACK tool to enable the 68040 copyback-cache feature over
  290.   the entire area of FastRAM. This typically yields an additional 20%
  291.   improvement over the basic ToolKit-enhanced figures.
  292.  
  293. ]--------------------------------------------------------------------[
  294.  
  295. Notes:
  296.  
  297. * The 16-bit display modes and screenblanking are only available on
  298.   Falcon machines, and won't work on anything else. Don't try to use
  299.   these features if you don't have a Falcon. Simply turn 'display'
  300.   'off' and 'verbose' 'on' to make sure these features are skipped.
  301.  
  302. * The POVMSDOS.DOC file covers a number of points which are still
  303.   relevant to this Atari version - mainly due to the fact it was
  304.   ported from the MSDOS sourcecode. Any PC specific information
  305.   however should be treated with due caution.
  306.  
  307. ]--------------------------------------------------------------------[
  308.  
  309. Have fun...
  310.  
  311. :)
  312.  
  313. Doug Little @ Black Scorpion ~ Jan '97
  314.